home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 041a / intune25.zip / INTUNE.DOC < prev    next >
Text File  |  1992-01-08  |  35KB  |  928 lines
  1.  
  2.  
  3.                                    InTune v2.5
  4.                          An AdLib ROL File Music Player
  5.          Copyright (c) 1990-1992 by Doug Brandon -- All Rights Reserved
  6.  
  7.  
  8.  
  9.                                 Table of Contents
  10.                                 
  11.  
  12.         1.  InTune Overview  . . . . . . . . . . . . . . . . . . . .   1
  13.  
  14.         2.  System Requirements  . . . . . . . . . . . . . . . . . .   1
  15.  
  16.         3.  License and Disclaimer . . . . . . . . . . . . . . . . .   1
  17.  
  18.         4.  Registration Information . . . . . . . . . . . . . . . .   2
  19.  
  20.         5.  InTune Options . . . . . . . . . . . . . . . . . . . . .   3
  21.  
  22.         6.  Loading a Sound Driver . . . . . . . . . . . . . . . . .   5
  23.  
  24.         7.  InTune Command Line Mode . . . . . . . . . . . . . . . .   5
  25.                   Playing Songs  . . . . . . . . . . . . . . . . . .   6
  26.                   Getting Technical Information  . . . . . . . . . .   7
  27.  
  28.         8.  InTune Full Screen Mode  . . . . . . . . . . . . . . . .   7
  29.                   Selecting Songs  . . . . . . . . . . . . . . . . .   8
  30.                   Marking Songs  . . . . . . . . . . . . . . . . . .   8
  31.                   Issuing Commands . . . . . . . . . . . . . . . . .   8
  32.                   Command Summary  . . . . . . . . . . . . . . . . .   9
  33.                   The Play Window  . . . . . . . . . . . . . . . . .  11
  34.  
  35.         9.  InTune Script Mode . . . . . . . . . . . . . . . . . . .  11
  36.                   Script Mode Commands . . . . . . . . . . . . . . .  12
  37.  
  38.         10. Miscellaneous  . . . . . . . . . . . . . . . . . . . . .  14
  39.  
  40.         11. History  . . . . . . . . . . . . . . . . . . . . . . . .  15
  41.  
  42.  
  43.         1.  InTune Overview
  44.         -----------------------------------------------------------------
  45.  
  46.               InTune  is  a  very versatile and easy to use program  that
  47.         plays  AdLib ROL format music files in a variety of ways: 1)  via
  48.         command  line  mode in which songs to play are specified  on  the
  49.         command  line at the DOS prompt, 2) via the full screen  mode  in
  50.         which all files are listed on the screen and you use the keyboard
  51.         and/or mouse to select songs to play, and 3) via the script  mode
  52.         where songs to play, and additional commands are specified  in  a
  53.         file.
  54.  
  55.               InTune supports playing of ROL files from within compressed
  56.         PKZIP  files, saving valuable disk space (most ROL files compress
  57.         up  to 80% using PKZIP).  InTune also supports 43/50 line display
  58.         mode on EGA/VGA displays, allowing display of up to 240 songs per
  59.         screen.   InTune can play songs at random, and you may also  mark
  60.         multiple songs to be played in any order you desire.
  61.  
  62.  
  63.         2.  System Requirements
  64.         -----------------------------------------------------------------
  65.  
  66.         InTune requires the following to run:
  67.              - IBM PC or compatible with DOS 3.0 or higher
  68.              - AdLib music synthesizer card (or equivalent) with
  69.                SOUND.COM driver from AdLib, Inc.  Sound Blaster card
  70.                requires SB-SOUND.COM driver from Creative Labs, Inc.
  71.              - 95K of free memory minimum (more depending on size of
  72.                instrument bank file and number and size of ROL files)
  73.  
  74.         The following hardware is not necessary, but supported:
  75.  
  76.              - Mouse
  77.              - EGA/VGA display hardware
  78.  
  79.  
  80.         3.  License and Disclaimer
  81.         -----------------------------------------------------------------
  82.  
  83.         InTune  is  copyrighted software, and all  rights  are  reserved.
  84.         InTune  may not be changed or modified in any way except  by  the
  85.         author.
  86.  
  87.         All  warranties,  whether expressed or implied,   are  disclaimed
  88.         relating to this software.  The author will not be liable for any
  89.         type  of  damage created by the use of InTune.  The user  of  the
  90.         software bears all risk as to the quality and performance of this
  91.         software.
  92.  
  93.         You   are   free   to  use,  copy  and  distribute   InTune   for
  94.         non  commercial use if: 1) The InTune distribution files are  not
  95.         modified in any way, and 2) no fee is charged for use, copying or
  96.         distribution.    Computer  user  groups   or   clubs,   or   disk
  97.         distributors of shareware may distribute InTune for a fee of  $10
  98.         or less in order to cover duplication and administrative costs.
  99.  
  100.                                      Page 1
  101.  
  102.         4.  Registration Information
  103.         -----------------------------------------------------------------
  104.  
  105.         InTune  is distributed as a "shareware" product.  The "shareware"
  106.         concept  gives  perspective  buyers an  opportunity  to  use  and
  107.         evaluate  a software package before deciding whether  or  not  to
  108.         purchase it.  You may use InTune freely for a ten (10) day  trial
  109.         period.  After the ten day trial period expires, you should  have
  110.         evaluated  this programs usefulness.  If you find InTune  useful,
  111.         and  continue to use it beyond the ten day trail period, you must
  112.         register  it  with  the author.  Registration  ensures  continued
  113.         support  and  development of InTune, as well  as  supporting  the
  114.         shareware concept.  Please support the user-supported (shareware)
  115.         concept!  You determine whether or not it will be worthwhile  for
  116.         myself and other shareware authors to continue developing quality
  117.         software.
  118.  
  119.         The   one-time  InTune  registration  fee  is  $20.    The   file
  120.         REGISTER.TXT  is  a registration form which is  distributed  with
  121.         this  package.   A  registration form may also  be  generated  by
  122.         typing the command "INTUNE /R".  I realize that some people  have
  123.         problems  finding  new ROL files, so I am also making  a  library
  124.         disk  of  compressed  ROL music files (over 550  ROL  files,  6MB
  125.         uncompressed)  available for an additional $5.  To register  your
  126.         copy  of InTune, print out the registration form and fill it  in.
  127.         Please do not forget to include shipping/handling charges.   Send
  128.         the completed form and funds to:
  129.  
  130.  
  131.                   Doug Brandon
  132.                   712 Stardust Drive
  133.                   Placentia, California  92670-4507
  134.  
  135.  
  136.  
  137.         This one-time registration of InTune will get you several things.
  138.         You  will receive a 5.25" disk which contains the latest  version
  139.         of  the  InTune  files.  This disk also contains a program  named
  140.         REGTUNE.EXE  (and instructions) which will register all  present,
  141.         and  future versions of InTune obtained from any BBS.   You  will
  142.         also  receive  a formatted  hardcopy of the latest documentation.
  143.         Registration  of InTune also removes the delays and  registration
  144.         notices at the beginning and end of the program.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.                                      Page 2
  160.  
  161.         5.  InTune Options
  162.         -----------------------------------------------------------------
  163.  
  164.              All of the options to be used with InTune are entered on the
  165.         command line at the DOS prompt.  The options used with InTune are
  166.         explained  in  detail  in  the  following  section,  along   with
  167.         examples.
  168.  
  169.              Listed below is a summary of important facts to keep in mind
  170.         while specifying InTune options.
  171.  
  172.              - The options can be typed using either upper case or lower
  173.                case.
  174.  
  175.              - All options must be preceded by a '/' or '-' character.
  176.  
  177.              - Typing "INTUNE ?", "INTUNE /? ", or "INTUNE /H" will
  178.                display a help screen showing all options.
  179.  
  180.              - Options may appear in any order.
  181.  
  182.              - Options can NOT be combined.
  183.  
  184.              - If an option is specified which contains a filename, and
  185.                the extension on the filename is omitted, the appropriate
  186.                extension will automatically be appended (.BNK for /B, and
  187.                .ZIP for /Z).
  188.  
  189.               The following table lists all of the InTune options, and  a
  190.         brief description of each option.  A more detailed explanation of
  191.         each option is in the next section.
  192.  
  193.              Option    Summary
  194.              ------    --------------------------------------------------
  195.                /B      Specify bankfile to use instead of STANDARD.BNK
  196.                /D      Specify an alternate directory for ROL files
  197.                /H      Display InTune options and help screen
  198.                /I      Display technical information on named ROL files
  199.                /R      Generate a registration form
  200.                /X      Use extended display in full screen mode
  201.                /Z      Specify PKZIP file to read songs from
  202.                /?      Same as /H
  203.  
  204.  
  205.  
  206.         /B = Specify an alternate instrument bank file
  207.  
  208.                InTune   defaults  to  using  the  instrument  bank   file
  209.         STANDARD.BNK.   This  option allows you  to  tell  InTune  use  a
  210.         different  instrument bankfile.  The name of the instrument  bank
  211.         file you wish to specify must immediately follow the "/B".  If  a
  212.         filename extension is omitted, ".BNK" is automatically appended.
  213.  
  214.         Examples:
  215.                   "INTUNE /BBIGBANK.BNK"
  216.                   "INTUNE /BCUSTOM
  217.  
  218.                                      Page 3
  219.  
  220.         /D = Specify an alternate directory for ROL files
  221.  
  222.               InTune defaults to looking in the current directory for the
  223.         ROL  files  to  play.  This option allows playing of  songs  from
  224.         other  directories.  The directory specification must immediately
  225.         follow the "/D".
  226.  
  227.         Examples:
  228.                   "INTUNE /D\ADLIB\ROLS"
  229.                   "INTUNE /DC:\ROLFILES"
  230.                   "INTUNE /D.."
  231.  
  232.  
  233.         /H (and /?) = Display InTune options and help screen
  234.  
  235.              This option displays how to invoke the three different modes
  236.         of  InTune,  and  a  list of the various  options  which  may  be
  237.         specified.
  238.  
  239.  
  240.         /I = Display ROL technical information.
  241.  
  242.               This  option forces InTune to read and display  information
  243.         contained  in the specified ROL files.  The information displayed
  244.         for each ROL file includes the following: name of instrument bank
  245.         file,  number of instruments in bankfile, name of ROL file, ticks
  246.         per  beat, beats per measure, music mode, basic tempo, play time,
  247.         instruments  used, instruments used which are  missing  from  the
  248.         instrument  bank  file, and event counts.  This  option  is  only
  249.         valid  when using the command line mode of InTune, and is ignored
  250.         otherwise.  This option may be used in combination with /Z.
  251.  
  252.         Examples:
  253.                   "INTUNE /I NEWS.ROL"
  254.                   "INTUNE /I ZARDOZ"
  255.  
  256.  
  257.         /X = Use extended display in InTune full screen mode
  258.  
  259.               If this option is specified, and InTune detects your system
  260.         is  equipped  with  an  EGA or VGA display,  it  will  switch  to
  261.         hi-resolution  display  mode  in the  InTune  full  screen  mode.
  262.         Depending on your type of display, EGA or VGA, InTune will switch
  263.         to  43 or 50 line mode.  This mode can allow InTune to display up
  264.         to  240  ROL  filenames at once.  If you do not have the  correct
  265.         hardware to support this function, an error message is displayed.
  266.         This  option  is  only valid when using the full screen  mode  of
  267.         InTune, and is ignored otherwise.
  268.  
  269.         Example:
  270.                   "INTUNE /X"
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                                      Page 4
  278.  
  279.         /Z = Specify PKZIP file to use
  280.  
  281.               InTune supports playing of ROL files from within compressed
  282.         PKZIP files.  Most ROL files compress up to 80% which can save  a
  283.         lot  of  valuable disk space.  When this option is used, all  ROL
  284.         files will be extracted and played from the specified PKZIP file,
  285.         and  deleted afterwards.  The name of the PKZIP file to use  must
  286.         immediately follow the "/Z".  If a filename extension is omitted,
  287.         ".ZIP" is automatically appended.  The PKUNZIP program must be in
  288.         one  of  the  directories specified in the DOS PATH  variable  in
  289.         order to use this option.
  290.  
  291.         Examples:
  292.                   "INTUNE /ZROLS.ZIP"
  293.                   "INTUNE /ZROLLIB"
  294.  
  295.  
  296.  
  297.         6.  Loading a Sound Driver
  298.         -----------------------------------------------------------------
  299.  
  300.               Before  you can run InTune, a sound driver must be  loaded.
  301.         This is a memory resident program (TSR) supplied by manufacturers
  302.         of  sound cards that manages the low level hardware interface  to
  303.         the  sound  card.  If you run InTune and a sound  driver  is  not
  304.         loaded, an error message will be displayed.
  305.  
  306.               All  AdLib  cards are shipped with a sound  driver  program
  307.         named  SOUND.COM.  To load the driver, just type "SOUND"  on  the
  308.         DOS  command  line.   This  sound  driver  optionally  takes  one
  309.         parameter, which is the size of an internal memory buffer used by
  310.         the sound driver.  For best results, use a buffer size of 1K.  To
  311.         load   the   sound  driver  with  a  1K  internal  buffer,   type
  312.         "SOUND  B1000" on the DOS command line.   You only need  to  load
  313.         the sound driver once.
  314.  
  315.               To  use InTune with the Sound Blaster card, you must obtain
  316.         the  sound driver program named SB-SOUND.COM from Creative  Labs,
  317.         Inc.
  318.  
  319.  
  320.  
  321.         7.  InTune Command Line Mode
  322.         -----------------------------------------------------------------
  323.  
  324.               The command line mode of InTune allows you to specify which
  325.         songs  to  play on the DOS command line.  This mode gives  you  a
  326.         quick  way  to play the songs you want with no hassle.   It  also
  327.         allows  you  to use InTune with other programs which  require  an
  328.         external  program  to play ROL files.  Both of the  DOS  wildcard
  329.         characters ? and * are supported for filename specification.  The
  330.         option /X is ignored in the command line mode of operation.
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                                      Page 5
  337.                                 
  338.         Playing Songs
  339.         -------------
  340.  
  341.               Playing  songs  with the command line mode  is  very  easy.
  342.         Simply  type INTUNE followed by the files you want to  play.   If
  343.         you do not specify file extensions, ".ROL" with automatically  be
  344.         appended to each filename.  The songs will then begin play in the
  345.         order  you specified.  While songs are playing you may press  the
  346.         space  bar  to skip the currently playing song, or you may  press
  347.         the  escape key to stop the playing of all songs.  The  following
  348.         examples  show a variety of ways to play songs using the  command
  349.         line mode:
  350.  
  351.  
  352.  
  353.         Play all ROL files in the current directory
  354.              INTUNE *   or   INTUNE *.ROL
  355.  
  356.         Play the three named ROL files in the current directory
  357.              INTUNE ZARDOZ.ROL AXEL-F STAIRWAY
  358.  
  359.         Play all ROL files beginning with the letter 'A'
  360.              INTUNE A*   or   INTUNE A*.ROL
  361.  
  362.         Play all three letter ROL files
  363.              INTUNE ???   or   INTUNE ???.ROL
  364.  
  365.         Play all ROL files contained in the PKZIP file ROLS.ZIP
  366.              INTUNE /ZROLS.ZIP *   or   INTUNE /ZROLS *.ROL
  367.  
  368.         Play RAIDERS.ROL from within the PKZIP file THEMES.ZIP
  369.              INTUNE /ZTHEMES.ZIP RAIDERS.ROL
  370.  
  371.         Play the three named ROL files from various directories
  372.              INTUNE C:\ROLS\REDBARCH ..\DARKMOON  D:\ROCK\CROWLEY.ROL
  373.  
  374.         Play all songs using an alternate instrument bank file
  375.              INTUNE /BBIGBANK.BNK *
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                      Page 6
  396.  
  397.         Getting Technical Information on Songs
  398.         --------------------------------------
  399.  
  400.               You can get technical information on the specified songs by
  401.         simply  adding the /I option to the command line.  A sound driver
  402.         does  not  need to be loaded in order to perform this  operation.
  403.         The following examples show a variety of ways to obtain technical
  404.         information on songs using the command line mode:
  405.  
  406.  
  407.         Get info on all ROL files in the current directory
  408.              INTUNE /I *   or   INTUNE /I *.ROL
  409.  
  410.         Get info on the three named ROL files in the current directory
  411.              INTUNE /I ZARDOZ.ROL AXEL-F STAIRWAY
  412.  
  413.         Get info on all ROL files contained in the PKZIP file ROLS.ZIP
  414.              INTUNE /I /ZROLS.ZIP *   or   INTUNE /I /ZROLS *.ROL
  415.  
  416.         Get info on RAIDERS.ROL from within the PKZIP file THEMES.ZIP
  417.              INTUNE /I /ZTHEMES.ZIP RAIDERS.ROL
  418.  
  419.         Get info on all songs using an alternate instrument bank file
  420.              INTUNE /I /BBIGBANK.BNK *
  421.  
  422.  
  423.  
  424.  
  425.         8.  InTune Full Screen Mode
  426.         -----------------------------------------------------------------
  427.  
  428.              The full screen mode of InTune is a user interactive mode in
  429.         which  you are presented with screens of ROL filenames.  You  use
  430.         the  keyboard  and/or mouse to select songs to  play,  and  issue
  431.         commands.  This is the most powerful and useful mode of InTune.
  432.  
  433.               The  top line of the screen always displays the InTune full
  434.         screen  commands.  The bottom two lines display various items  of
  435.         information  including name and size of currently selected  song,
  436.         time  of  day,  number of instruments loaded from the  instrument
  437.         bank  file,  sound driver version number, amount of free  memory,
  438.         and  the name of the PKZIP file being used (if the /Z option  was
  439.         specified).   All other lines in between are used to display  the
  440.         names of songs.
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.                                      Page 7
  455.  
  456.         Selecting Songs
  457.         ---------------
  458.  
  459.              Selection of songs involves positioning a highlighted cursor
  460.         over  the desired song to select or play.  To select songs  using
  461.         the keyboard, the following keys may be used:
  462.  
  463.              - The four arrow keys may be used to move the cursor up,
  464.                down, right or left.
  465.              - The home key moves the cursor to the first song.
  466.              - The end key moves the cursor to the last song.
  467.              - The page up and page down keys move forward and backward
  468.                through the various display screens.
  469.              - Pressing a letter between 'A' and 'Z' moves the cursor to
  470.                the first song beginning with that letter.
  471.  
  472.               To select songs using the mouse, position the mouse pointer
  473.         over  the  desired song, and single click the left mouse  button.
  474.         The  page  up and page down keys may be simulated by placing  the
  475.         mouse  pointer  on  either  the right or  left  arrow  characters
  476.         located  on  the top righthand of the screen and single  clicking
  477.         the left mouse button (note: these arrow characters are displayed
  478.         only if a mouse is detected).
  479.  
  480.  
  481.  
  482.         Marking Songs
  483.         -------------
  484.  
  485.               You  may mark multiple songs for playing.  To mark  a  song
  486.         using  the keyboard, position the cursor to the song you wish  to
  487.         mark,  and  then press the space bar.  To mark a song  using  the
  488.         mouse,  place the mouse pointer over the song you wish  to  mark,
  489.         and  single  click the right mouse button.  If the song  was  not
  490.         previously  marked, a green number indicating the songs  position
  491.         in the marked song queue will appear next to the song.  To unmark
  492.         a  song, just hit the space bar again, or single click the  right
  493.         mouse button again, the green number will disappear, and the song
  494.         will be unmarked.
  495.  
  496.  
  497.  
  498.         Issuing Commands
  499.         ----------------
  500.  
  501.               The InTune full screen mode commands are listed on the  top
  502.         line  of  the display.  Each command has a highlighted letter  in
  503.         its  name,  which  is  the  "command letter"  for  that  command.
  504.         Pressing    the   ALT   key   together   with   the   highlighted
  505.         "command letter" invokes the command.  To invoke a command  using
  506.         the mouse, just place the mouse pointer over the desired command,
  507.         and single click the left mouse button.
  508.  
  509.  
  510.  
  511.  
  512.  
  513.                                      Page 8
  514.  
  515.         Command Summary
  516.         ---------------
  517.  
  518.               A  description  of each command, as well  as  the  keyboard
  519.         sequence to invoke each command follows:
  520.  
  521.         About    (ALT-A)
  522.               Pops  up a window and displays a copyright notice,  program
  523.         version  information, and how to contact the author.  The release
  524.         date of the program is also located in the lower right corner  of
  525.         this window.
  526.  
  527.         Play     (ALT-P or <return> or double-click left mouse button)
  528.              Begins playing songs, and pops up the play window (described
  529.         later).   If there are no songs marked, the currently highlighted
  530.         song is played, otherwise the first marked song begins playing.
  531.  
  532.         Repeat   (ALT-R)
  533.              This command enables or disables the repeat mode, which only
  534.         takes  effect  when  songs are playing.   This  command  will  be
  535.         highlighted if the repeat mode is enabled, otherwise it  will  be
  536.         displayed  normally  if disabled.  If no songs  are  marked,  the
  537.         currently  highlighted song will play repeatedly  until  stopped.
  538.         If  there are marked songs, the entire marked song queue will  be
  539.         played repeatedly until stopped.
  540.  
  541.         Shuffle  (ALT-F)
  542.              The shuffle command continuously plays songs at random until
  543.         stopped.  A song will never be played twice in a row unless there
  544.         is only one song.
  545.  
  546.         Clear    (ALT-C)
  547.               The  clear  command unmarks all songs, clearing the  marked
  548.         song queue.
  549.  
  550.         Markall  (ALT-M)
  551.               The  markall command marks all songs, placing all songs  in
  552.         the  marked song queue.  If there were already some songs  marked
  553.         before invoking the Markall command, the position of those  songs
  554.         in  the marked song queue is retained, and all unmarked songs are
  555.         place in the queue after the already marked songs.
  556.  
  557.         Info     (ALT-I)
  558.               Displays  technical information for the currently  selected
  559.         song.   This  information  includes the following:  name  of  the
  560.         current  instrument  bank  file  being  used,  version   of   the
  561.         instrument  bank file, number of entries used in  the  instrument
  562.         bank  file,  name and version of ROL file, number  of  ticks  per
  563.         beat,  number  of  beats per measure, music  mode,  basic  tempo,
  564.         playing  time, instruments used in the song, instruments used  in
  565.         the  song which are missing from the instrument bank file, and  a
  566.         table  of  event  types and counts.  Most of this information  is
  567.         useless  to the average user, but is supplied for the people  who
  568.         are experimenting with ROL files.
  569.  
  570.  
  571.  
  572.                                      Page 9
  573.  
  574.         DOS      (ALT-D)
  575.              Invokes a DOS shell.  This command will only work when there
  576.         are no songs playing.  When you are finished using the DOS shell,
  577.         type "EXIT" to return to InTune.
  578.  
  579.         Quit     (ALT-Q)
  580.              Immediately stops playing songs and exits the program.
  581.  
  582.         Help     (ALT-H or F1)
  583.              Pops up the on-line help information window.
  584.  
  585.         Arrows
  586.               If a mouse is detected in your system, left and right arrow
  587.         characters  are  displayed, and may be used  by  mouse  users  to
  588.         switch  between pages (same as page up and page down  when  using
  589.         the  keyboard).   These arrows will only appear  if  a  mouse  is
  590.         detected in your system.
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.                                      Page 10
  632.  
  633.         The Play Window
  634.         ---------------
  635.  
  636.               When  songs are played in the InTune full screen mode,  the
  637.         play window appears.  This window displays information about  the
  638.         song   currently  being  played,  and  adds  three  song  control
  639.         commands.  The play window looks like this:
  640.  
  641.                ╔═════════════════════════════════════════════════╗
  642.                ║                                                 ║
  643.                ║               Playing ZARDOZ.ROL                ║
  644.                ║                                                 ║
  645.                ║               Progress Indicator                ║
  646.                ║            ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▌    0%        ║
  647.                ║                                                 ║
  648.                ║   Time Remaining 01:38    Time Elapsed 00:00    ║
  649.                ║                                                 ║
  650.                ║           Stop       Pause       Skip           ║
  651.                ║                                                 ║
  652.                ╚═════════════════════════════════════════════════╝
  653.  
  654.               The  top  line  of  the  window describes  what  InTune  is
  655.         presently  doing (unzipping, loading, playing, or deleting),  and
  656.         the  name of the ROL file it is operating on.  Error messages are
  657.         also  displayed on this line.  The next line contains three items
  658.         of  information. The musical note on the left side of the  window
  659.         will  be  red when the song is still being loaded into the  sound
  660.         driver queues, and will change to green when the entire song  has
  661.         been  loaded.   The middle of this line contains a "meter"  which
  662.         gives  you  a  visual  indication of the  progress  of  the  song
  663.         currently being played.  There are twenty positions on the meter,
  664.         and one position is lighted for every 5% of the song played.  The
  665.         right  side  of this line shows the percentage of the song  which
  666.         has  been  played.  The next line displays the time remaining  of
  667.         the  current  song, as well as elapsed time of the current  song.
  668.         The  bottom line gives you the option of stopping the play of all
  669.         songs,  and  pausing or skipping the current song.   These  three
  670.         options  are additional commands which may be invoked by  command
  671.         key sequences, or by using the mouse.
  672.  
  673.  
  674.  
  675.         9.  InTune Script Mode
  676.         -----------------------------------------------------------------
  677.  
  678.               The  InTune script mode reads InTune commands from an ASCII
  679.         text file.  Not only does this mode play songs, but also provides
  680.         screen  output  and  control, as well  as  access  to  other  DOS
  681.         programs.  This mode of InTune can be useful for creating  simple
  682.         demonstrations.
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.                                      Page 11
  691.  
  692.         Script Mode Commands
  693.         --------------------
  694.  
  695.         #
  696.  
  697.               Any line with the # character in the first column signifies
  698.         that  the rest of the line is to be ignored.  This is useful  for
  699.         placing  commands  in your script files.  Blank  lines  are  also
  700.         ignored.  Example:
  701.  
  702.              #this line is a comment
  703.  
  704.  
  705.         !
  706.  
  707.               Any line with the ! character in the first column signifies
  708.         that the rest of the line is to be treated as a DOS command.  The
  709.         entire line past the ! character is passed to COMMAND.COM and  is
  710.         executed.   This is useful for shelling out to DOS to temporarily
  711.         run  other programs.  For example, it is possible to run VPIC  to
  712.         display and leave a GIF picture on the screen, and play a song at
  713.         the  same time, or run another program which modifies the  screen
  714.         before playing a song.  Example:
  715.  
  716.              !vpic /r astron.gif
  717.  
  718.  
  719.         GOTOXY column row
  720.  
  721.               This command places the cursor at the position specified by
  722.         the  user  specified coordinates column and row.  This is  mainly
  723.         used  to  position  the cursor before using the  SAY  command  to
  724.         output text.  Example:
  725.  
  726.              GOTOXY 1 20
  727.  
  728.  
  729.         SAY text
  730.  
  731.               This  command outputs the specified text.  If there  is  no
  732.         text  specified with this command, a carriage return and linefeed
  733.         are output.  Example:
  734.  
  735.              SAY Now playing "Stairway to Heaven"
  736.              SAY
  737.              SAY Press escape to quit
  738.  
  739.  
  740.         CLS
  741.  
  742.              This command clears the screen.  Example:
  743.  
  744.              CLS
  745.  
  746.  
  747.  
  748.  
  749.                                      Page 12
  750.                                 
  751.         COLOR foreground [ON background]
  752.  
  753.               This command sets the attributes which are to be used  when
  754.         the SAY command is used to output text.  This command sets either
  755.         the  foreground  color,  or  both the foreground  and  background
  756.         colors.   If  you want to set both the foreground and  background
  757.         colors,  the  keyword "ON" must separate the color names.   Valid
  758.         color  names are black, blue,  green, cyan,  red, magenta, brown,
  759.         lightgray, darkgray, lightblue, lightgreen,  lightcyan, lightred,
  760.         lightmagenta, yellow, and white.  Examples:
  761.  
  762.              COLOR RED
  763.              COLOR WHITE ON BLUE
  764.  
  765.  
  766.         PAUSE [KEY] [seconds]
  767.  
  768.              This command either pauses InTune until a key is pressed, or
  769.         pauses for the specified number of seconds.  Examples:
  770.  
  771.              PAUSE KEY                ;pauses until a key is pressed
  772.              PAUSE 5                  ;pauses for 5 seconds
  773.  
  774.  
  775.         PLAY rolfile
  776.  
  777.               This command starts playing the specified song, and outputs
  778.         the  message  "Playing rolfile...".  If an extension is  omitted,
  779.         ".ROL" is automatically appended to the filename.  The space  bar
  780.         may be pressed to skip the currently playing song, and the escape
  781.         key  aborts  the  script  file and returns  to  the  DOS  prompt.
  782.         Examples:
  783.  
  784.              PLAY STAIRWAY.ROL
  785.              PLAY STAIRWAY
  786.  
  787.  
  788.         PLAYX rolfile
  789.  
  790.              This command starts playing the specified song, but does not
  791.         output  any message.  This command is intended for the  user  who
  792.         wants  to  output his own message describing the  song  which  is
  793.         about  to  play.  If an extension is omitted from  the  filename,
  794.         ".ROL"  is automatically appended.  The space bar may be  pressed
  795.         to skip the currently playing song, and the escape key aborts the
  796.         script file and returns to the DOS prompt.  Examples:
  797.  
  798.              PLAYX STAIRWAY.ROL
  799.              PLAYX STAIRWAY
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.                                      Page 13
  809.  
  810.         10.  Miscellaneous
  811.         -----------------------------------------------------------------
  812.  
  813.               If  you use the extended display mode and the mouse pointer
  814.         does  not go below the 25th row, you must get a newer version  of
  815.         your mouse driver.  Earlier versions of various mouse drivers  do
  816.         not support the mouse pointer below the 25th row.
  817.  
  818.               The  compression related routines used in InTune have  been
  819.         tested with PKUNZIP version 1.1.
  820.  
  821.  
  822.         The  InTune program and documentation is copyright (c)  1990-1992
  823.         by Doug Brandon.  All rights reserved.
  824.  
  825.  
  826.         If  you  have  comments  or suggestions for  future  versions  of
  827.         InTune, please send them to me at the following address:
  828.  
  829.              Doug Brandon
  830.              712 Stardust Drive
  831.              Placentia, California  92670-4507
  832.  
  833.  
  834.  
  835.         I can also be reached by the following:
  836.  
  837.              Prodigy: CTJP63A
  838.  
  839.              Motown LA-BBS:      (714) 535-1319  HST
  840.              N.S.T.T.Z:          (714) 879-4052  HST
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.                                      Page 14
  868.  
  869.         11.  History
  870.         -----------------------------------------------------------------
  871.  
  872.         01/08/92 - Version 2.5 released, minor revision
  873.                        * Now loads large instrument bank files bigger
  874.                          than 64K.
  875.                        * Added command line parameter /R to generate
  876.                          registration forms.
  877.                        * Reads PKZIP file directory 100% faster
  878.                        * Added DOS Shell to full screen mode
  879.                        * Time of day added to full screen mode
  880.                        * Instrument count added to full screen mode
  881.                        * Added shadows to most pop-up windows
  882.                        * A few minor bug fixes
  883.                        * ROL Library Disk made available
  884.                        * Changed my mailing address
  885.  
  886.  
  887.         05/01/91 - Version 2.0 released, major revision
  888.                        * Rewritten sound routines
  889.                        * Command line mode & script mode added
  890.                        * ZIP file support added
  891.                        * Shuffle mode added
  892.                        * Multiple song queue added (marking songs)
  893.                        * Online help added
  894.                        * 43/50 line display support added
  895.                        * ROL technical information display added
  896.                        * several minor bug fixes
  897.                        * option help screen added (INTUNE /?)
  898.  
  899.         09/25/90 - Version 1.0, Initial Release
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                                      Page 15
  927.  
  928.